package cn.iocoder.yudao.module.crm.service.subject;

import cn.iocoder.yudao.framework.common.pojo.LayuiTreeNode;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.crm.controller.admin.subject.vo.SubjectListReqVO;
import cn.iocoder.yudao.module.crm.controller.admin.subject.vo.SubjectPageReqVO;
import cn.iocoder.yudao.module.crm.controller.admin.subject.vo.SubjectSaveReqVO;
import cn.iocoder.yudao.module.crm.dal.dataobject.subject.SubjectDO;
import jakarta.validation.Valid;

import java.util.List;

/**
 * 栏目 Service 接口
 *
 * @author 管理员
 */
public interface SubjectService {

    /**
     * 创建栏目
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createSubject(@Valid SubjectSaveReqVO createReqVO);

    /**
     * 更新栏目
     *
     * @param updateReqVO 更新信息
     */
    void updateSubject(@Valid SubjectSaveReqVO updateReqVO);

    /**
     * 删除栏目
     *
     * @param id 编号
     */
    void deleteSubject(Long id);

    /**
     * 获得栏目
     *
     * @param id 编号
     * @return 栏目
     */
    SubjectDO getSubject(Long id);

    /**
     * 获得栏目分页
     *
     * @param pageReqVO 分页查询
     * @return 栏目分页
     */
    PageResult<SubjectDO> getSubjectPage(SubjectPageReqVO pageReqVO);


    /**
     * 筛选栏目列表
     *
     * @param reqVO 筛选条件请求 VO
     * @return 栏目列表
     */
    List<SubjectDO> getSubjectList(SubjectListReqVO reqVO);

    List<LayuiTreeNode> buildSubjectTree();

}